<!DOCTYPE html>
<html lang="en">
    <head>
            <meta charset="utf-8">
            <meta http-equiv="X-UA-Compatible" content="IE=edge">
            <meta name="viewport" content="width=device-width, initial-scale=1.0">
            
            
            
            <link rel="shortcut icon" href="../../../img/favicon.ico">
        
        <script type="text/javascript" src="//game.bmob.cn/static/doc_union.js"></script>
            <title>Bmob文档中心</title>
            <link href="../../../css/bootstrap-custom.min.css" rel="stylesheet">
            <link href="../../../css/font-awesome-4.5.0.css" rel="stylesheet">
            <link href="../../../css/base.css" rel="stylesheet">
            <link rel="stylesheet" href="../../../css/highlight.css">
            <link href="../../../css/agate.css" rel="stylesheet">
            <link href="../../../css/custom.css" rel="stylesheet" id="custom">
    </head>

    <body >

        <div class="navbar navbar-fixed-top" role="navigation">
    <div class="main-nav">
        <!-- Collapsed navigation -->
        <div class="navbar-header">
            <a class="navbar-brand" href="../../..">
                <!--Bmob文档中心-->
                <img src="../../../img/logo.png" alt="">
            </a>
        </div>

        <!-- Expanded navigation -->
        <div class="navbar-collapse collapse">

          <ul class="nav navbar-nav">
            
              <li class="pull-left">
                
					<a href="../../..">文档首页</a>
                
              </li>
            
              <li class="pull-left active">
                
					<!--<a href="">数据服务</a>-->
					<li class="dropdown active">
                        <a href="#" class="dropdown-toggle" data-toggle="dropdown">数据服务 <b class="caret"></b></a>
                        <ul class="dropdown-menu">
                            
								<li >
									<a href="../../android/">Android</a>
                                </li>
                            
                            
								<li >
									<a href="../../ios/">iOS</a>
                                </li>
                            
                            
								<li >
									<a href="../../csharp/">C#</a>
                                </li>
                            
                            
								<li >
									<a href="../../php/">PHP</a>
                                </li>
                            
                            
								<li >
									<a href="../../go/">GO</a>
                                </li>
                            
                            
								<li >
									<a href="../../restful/">RESTful</a>
                                </li>
                            
                            
								<li class="active">
									<a href="../">JavaScript</a>
                                </li>
                            
                            
                                <li >
                                    <a href="../../cocos2d_x/">Cocos2D-X</a>
                                </li>
							
                            
								<li >
									<a href="../../wechat_app/">小程序</a>
                                </li>
                            
                            
                                <li >
                                    <a href="../../wechat_app_new/">快应用</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../wechat_app_new/">Nodejs</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../wechat_app_new/">Cocos Creator</a>
                                </li>
							
                            
								<li >
									<a href="../../wechat_app_new/rm/">小程序(新)</a>
                                </li>
                            
                        </ul>
                    </li>
                
              </li>
            
              <li class="pull-left">
                
					<!--<a href="../../../cloud_function/android/">云函数</a>-->
					<li class="dropdown">
                        <a href="#" class="dropdown-toggle" data-toggle="dropdown">云函数 <b class="caret"></b></a>
                        <ul class="dropdown-menu">
                            
                                <li >
                                    <a href="../../../cloud_function/android/">Android</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../cloud_function/ios/">iOS</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../cloud_function/java/">Java</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../cloud_function/csharp/">C#</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../cloud_function/php/">PHP</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../cloud_function/javascript/">JavaScript</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../cloud_function/restful/">RESTful</a>
                                </li>
							
                            
								<li >
									<a href="../../../cloud_function/web/">Web</a>
                                </li>
                            
                        </ul>
                    </li>
                
              </li>
            
              <li class="pull-left">
                
					<!--<a href="../../../sms/android/">短信服务</a>-->
					<li class="dropdown">
                        <a href="#" class="dropdown-toggle" data-toggle="dropdown">短信服务 <b class="caret"></b></a>
                        <ul class="dropdown-menu">
                            
                                <li >
                                    <a href="../../../sms/android/">Android</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../sms/ios/">iOS</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../sms/php/">PHP</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../sms/javascript/">JavaScript</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../sms/restful/">RESTful</a>
                                </li>
							
                        </ul>
                    </li>
                
              </li>
            
              <li class="pull-left">
                
					<!--<a href="">游戏实时后端</a>-->
					<li class="dropdown">
                        <a href="#" class="dropdown-toggle" data-toggle="dropdown">游戏实时后端 <b class="caret"></b></a>
                        <ul class="dropdown-menu">
                            
								<li >
									<a href="../../../game/unity/quick_start/">Unity</a>
                                </li>
                            
                            
								<li >
									<a href="../../../game/cocos_creator/quick_start/">Cocos Creator</a>
                                </li>
                            
                            
								<li >
									<a href="../../../game/wechat_games/quick_start/">微信小游戏</a>
                                </li>
                            
                            
                                <li >
                                    <a href="../../../game/cloud_function/develop_doc/">云函数</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../game/classic_case/">经典案例</a>
                                </li>
							
                        </ul>
                    </li>
                
              </li>
            
              <li class="pull-left">
                
					<!--<a href="">IM服务</a>-->
					<li class="dropdown">
                        <a href="#" class="dropdown-toggle" data-toggle="dropdown">IM服务 <b class="caret"></b></a>
                        <ul class="dropdown-menu">
                            
								<li >
									<a href="../../../im/android/">Android</a>
                                </li>
                            
                            
								<li >
									<a href="../../../im/ios/">iOS</a>
                                </li>
                            
                        </ul>
                    </li>
                
              </li>
            
              <li class="pull-left">
                
					<!--<a href="../../../push/android/">推送服务</a>-->
					<li class="dropdown">
                        <a href="#" class="dropdown-toggle" data-toggle="dropdown">推送服务 <b class="caret"></b></a>
                        <ul class="dropdown-menu">
                            
                                <li >
                                    <a href="../../../push/android/">Android</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../push/ios/">iOS</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../push/php/">PHP</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../push/javascript/">JavaScript</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../push/restful/">RESTful</a>
                                </li>
							
                        </ul>
                    </li>
                
              </li>
            
              <li class="pull-left">
                
					<!--<a href="../../../other/common_problem/">其他</a>-->
					<li class="dropdown">
                        <a href="#" class="dropdown-toggle" data-toggle="dropdown">其他 <b class="caret"></b></a>
                        <ul class="dropdown-menu">
                            
                                <li >
                                    <a href="../../../other/common_problem/">常见问题</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../other/error_code/">错误码</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../other/data_safety/">数据安全</a>
                                </li>
							
                            
                                <li >
                                    <a href="../../../other/bql/">BQL</a>
                                </li>
							
                        </ul>
                    </li>
                
              </li>
            
              <li>
                  <a href="https://www.bmob.cn/repository/index" target="_blank">知识库</a>
              </li>
              <li>
                  <a href="http://doc.bmob.cn/video/index.html" target="_blank">视频教程</a>
              </li>
            </ul>
            
        </div>
    </div>
</div>

        <div class="pagebody" id="main-wrapper">
            <div class="sidebar">
                <div class="bs-sidebar hidden-print affix well" role="complementary">

	
		
	
		
				
				
				
				
				
				
				
					<div class="code-title">JavaScript</div>
				
				
				
				
				
				
				
		
	
		
				
				
				
				
				
				
				
				
		
	
		
				
				
				
				
				
		
	
		
				
				
				
				
				
		
	
		
				
				
		
	
		
				
				
				
				
				
		
	
		
				
				
				
				
		
	


	<ul class="nav bs-sidenav">
		
			
		
			
				
					
						
					
						
					
						
					
						
					
						
					
						
					
						
							
								
									<li class="">
										<a class="itm-l1" href="../">快速入门</a>
										
									</li>
								
									<li class="active">
										<a class="itm-l1" href="./">开发文档</a>
										
										<ul class="nav">
											
											<li class="active "><a href="#_1">简介</a>
												
											</li>
												
											<li class=""><a href="#_2">典型案例</a>
												
											</li>
												
											<li class=""><a href="#_3">应用程序</a>
												
											</li>
												
											<li class=""><a href="#_4">对象</a>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_5">数据对象</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_6">创建对象</a></li>
												</ul>
												
											</li>
												
											<li class=""><a href="#_7">添加数据</a>
												
											</li>
												
											<li class=""><a href="#_8">查询数据</a>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_9">查询所有数据</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_10">获取对象的特殊属性</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_11">查询单条数据</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_12">条件查询</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_13">分页查询</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_14">结果排序</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_15">统计记录数量</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_16">复杂查询</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_17">查询指定列</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_18">对字符串类型做查询</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_19">或查询</a></li>
												</ul>
												
											</li>
												
											<li class=""><a href="#_20">修改数据</a>
												
											</li>
												
											<li class=""><a href="#_21">删除数据</a>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_22">删除字段</a></li>
												</ul>
												
											</li>
												
											<li class=""><a href="#_23">常见数据类型的操作</a>
												
											</li>
												
											<li class=""><a href="#_24">数组操作</a>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_25">添加及更新数组</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_26">数组查询</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_27">删除数组</a></li>
												</ul>
												
											</li>
												
											<li class=""><a href="#_28">数据关联</a>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_29">添加及修改关联关系</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_32">查询关联关系</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_33">删除关联关系</a></li>
												</ul>
												
											</li>
												
											<li class=""><a href="#_34">原子计数器</a>
												
											</li>
												
											<li class=""><a href="#_35">文件</a>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_36">整个文件上传</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_37">文件删除</a></li>
												</ul>
												
											</li>
												
											<li class=""><a href="#_38">图片处理</a>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_39">缩微图</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_40">水印图</a></li>
												</ul>
												
											</li>
												
											<li class=""><a href="#promise">Promise</a>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#then">then 方法</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#promise_1">将Promise 组织在一起</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_41">错误处理</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#promise_2">创建 Promise</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#promise_3">顺序的Promise</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#promise_4">并行的Promise</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_42">创建异步方法</a></li>
												</ul>
												
											</li>
												
											<li class=""><a href="#collection">Collection</a>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#collection_1">获取Collection</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#collection_2">Collection 排序</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#collection_3">修改一个 Collection</a></li>
												</ul>
												
											</li>
												
											<li class=""><a href="#_43">用户</a>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_44">属性</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_45">注册</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_46">登录</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#email">验证 Email</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_47">当前用户</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_48">用户对象的安全</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_49">其他对象的安全</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_50">重设密码</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_51">查询</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_52">关联</a></li>
												</ul>
												
											</li>
												
											<li class=""><a href="#_53">实时数据平台</a>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_54">实时功能简介</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#js">安装实时数据平台的js</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_55">订阅事件</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_59">取消订阅事件</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_63">监听触发的事件</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#demo">demo</a></li>
												</ul>
												
											</li>
												
											<li class=""><a href="#acl">ACL和角色</a>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#acl_1">ACL的格式</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_67">角色和相关操作</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_68">创建角色</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_69">角色对象的安全性</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_70">其他对象的安全性</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_71">角色继承</a></li>
												</ul>
												
											</li>
												
											<li class=""><a href="#_72">地理位置</a>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_73">创建地理位置对象</a></li>
												</ul>
												
												<ul class="nav nav-l2">
													<li><a class="itm-l2" href="#_74">查询地理位置对象</a></li>
												</ul>
												
											</li>
												
											<li class=""><a href="#_75">错误代码详细说明</a>
												
											</li>
												
										</ul>
										
									</li>
								
									<li class="">
										<a class="itm-l1" href="../example/">示例/功能</a>
										
									</li>
								
							
						
					
						
					
						
					
						
					
						
					
						
					
						
					
				
			
		
			
		
			
		
			
		
			
		
			
		
			
		
	</ul>
</div>
            </div>
            <div class="content" role="main">
                <div class="wrap">
                    

<h2 id="_1">简介<a class="headerlink" href="#_1" title="Permanent link">&para;</a></h2>
<ul>
<li>
<p>Bmob平台为您的移动应用提供了一个完整的后端解决方案，我们提供轻量级的SDK开发包，让开发者以最小的配置和最简单的方式使用Bmob平台提供的服务，进而完全消除开发者编写服务器代码以及维护服务器的操作。</p>
</li>
<li>
<p>Bmob的JavaScript SDK基于<code>Backbone.js</code>框架开发，在使用过程中除<code>Bmob.view</code>类需要提供jQuery或者类似JQuery的<code>$</code>方法外，不需要再引入其他类库。</p>
</li>
</ul>
<h2 id="_2">典型案例<a class="headerlink" href="#_2" title="Permanent link">&para;</a></h2>
<p>聊天室：<a href="http://chatroom.bmob.cn">http://chatroom.bmob.cn</a> （采用实时数据同步SDK开发，右击可直接查看源码）</p>
<h2 id="_3">应用程序<a class="headerlink" href="#_3" title="Permanent link">&para;</a></h2>
<p>在Bmob平台注册后，每个账户可创建多个应用程序，创建的每个应用程序都有其独自的应用程序ID，此后所有的应用程序将凭其ID进行Bmob SDK的使用。即使只有一个应用程序，也可以以不同的版本进行测试和生产。</p>
<h2 id="_4">对象<a class="headerlink" href="#_4" title="Permanent link">&para;</a></h2>
<h3 id="_5">数据对象<a class="headerlink" href="#_5" title="Permanent link">&para;</a></h3>
<p>Bmob数据存储是建立在<code>Bmob.Object</code>基础上的。如记录游戏成绩的<code>Bmob.Object</code>示例如下：</p>
<pre><code>score: 1337, playerName: &quot;bmob&quot;, cheatMode: false
</code></pre>

<p>这里需要注意的是：</p>
<ul>
<li>键必须是字母或者数字的字符串，值可以是字符串、数字、布尔值或者数组和字典。</li>
<li>每一个<code>Bmob.Object</code>都是一个特定子类的实例，子类名可以来区分各种数据，如我们可以把记录游戏成绩的类称之为<code>GameScore</code>。</li>
</ul>
<h3 id="_6">创建对象<a class="headerlink" href="#_6" title="Permanent link">&para;</a></h3>
<p>你可以使用<code>Bmob.Object.extend</code>方法来创建新的<code>Bmob.Object</code>子类，示例代码如下：</p>
<pre><code>// 创建Bmob.Object子类
var GameScore = Bmob.Object.extend(&quot;GameScore&quot;);

// 创建该类的一个实例
var gameScore = new GameScore();

</code></pre>

<p>如果你想为<code>Bmob.Object</code>的子类添加一些实例方法和类方法，示例代码如下：</p>
<pre><code>// 为Bmob.Object的子类添加实例方法和类方法
var GameScore = Bmob.Object.extend(&quot;GameScore&quot;, {
  //实例方法
  gleaterThanOneHundred: function() {
    return this.get(&quot;score&quot;) &gt; 100;
  }
}, {
  //类方法
  spawn: function(score) {
    var gameScore = new GameScore();
    gameScore.set(&quot;score&quot;, score);
    return gameScore;
  }
});

var gameScore = GameScore.spawn(200);
alert(gameScore.gleaterThanOneHundred()); 
</code></pre>

<h2 id="_7">添加数据<a class="headerlink" href="#_7" title="Permanent link">&para;</a></h2>
<p>添加数据非常简单，任何<code>Bmob.Object</code>子类都有<code>save</code>方法可以用于将当前对象的内容保存到服务端。示例代码如下：</p>
<pre><code>//创建类和实例
var GameScore = Bmob.Object.extend(&quot;GameScore&quot;);
var gameScore = new GameScore();
gameScore.set(&quot;score&quot;, 137);
gameScore.set(&quot;playerName&quot;, &quot;bmob&quot;);
gameScore.set(&quot;cheatMode&quot;, false);
//添加数据，第一个入口参数是null
gameScore.save(null, {
  success: function(gameScore) {
    // 添加成功，返回成功之后的objectId（注意：返回的属性名字是id，不是objectId），你还可以在Bmob的Web管理后台看到对应的数据
    alert('添加数据成功，返回的objectId是：' + gameScore.id);
  },
  error: function(gameScore, error) {
    // 添加失败
    alert('添加数据失败，返回错误信息：' + error.description);
  }
});
</code></pre>

<p>你也可以用如下的示例代码添加数据：</p>
<pre><code>var GameScore = Bmob.Object.extend(&quot;GameScore&quot;);
var gameScore = new GameScore();
// 添加数据，第一个入口参数是Json数据
gameScore.save({
  score: 1337,
  playerName: &quot;bmob&quot;,
  cheatMode: false
}, {
  success: function(gameScore) {
    // 添加成功
  },
  error: function(gameScore, error) {
    // 添加失败
  }
});
</code></pre>

<p>这里有几点需要注意的是:</p>
<ol>
<li>如果云端数据库中不存在<code>GameScore</code>表，Bmob会自动地在你第一次使用它的时候创建。</li>
<li>每个<code>Bmob.Object</code>对象都有几个默认的字段是自动创建的：<code>objectId</code>是一个对于每一个保存的对象为一个标志；<code>createdAt</code>和<code>updatedAt</code>表示对象在Bmob中创建和最后一次更改的时间。这些字段的创建和内容是由服务器端自动完成的，在保存<code>Bmob.Object</code>之前不会存在。</li>
<li>添加成功后，可以通过<code>gameScore.createdAt</code>获取对象的创建时间，通过<code>gameScore.updatedAt</code>获取对象的更新时间；可以通过<code>gameScore.id</code>获取对象的objectId。</li>
</ol>
<h2 id="_8">查询数据<a class="headerlink" href="#_8" title="Permanent link">&para;</a></h2>
<p>数据的查询是每个应用都会频繁使用到的，Bmob提供了<code>Bmob.Object</code>类，方便大家实现不同条件的查询。</p>
<h3 id="_9">查询所有数据<a class="headerlink" href="#_9" title="Permanent link">&para;</a></h3>
<p>查询某个数据表中的所有数据是非常简单的，只需要使用<code>Bmob.Query</code>的<code>find</code>方法就可以了，示例代码如下：</p>
<pre><code>var GameScore = Bmob.Object.extend(&quot;GameScore&quot;);
var query = new Bmob.Query(GameScore);
// 查询所有数据
query.find({
  success: function(results) {
    alert(&quot;共查询到 &quot; + results.length + &quot; 条记录&quot;);
    // 循环处理查询到的数据
    for (var i = 0; i &lt; results.length; i++) {
      var object = results[i];
      alert(object.id + ' - ' + object.get('playerName'));
    }
  },
  error: function(error) {
    alert(&quot;查询失败: &quot; + error.code + &quot; &quot; + error.message);
  }
});
</code></pre>

<p>如果你只想要一个结果，一个更加方便的方法是使用<code>first</code>，而不是<code>find</code>方法，示例代码如下：</p>
<pre><code>var GameScore = Bmob.Object.extend(&quot;GameScore&quot;);
var query = new Bmob.Query(GameScore);
query.first({
  success: function(object) {
    // 查询成功
  },
  error: function(error) {
    alert(&quot;查询失败: &quot; + error.code + &quot; &quot; + error.message);
  }
});
</code></pre>

<p><strong>这里需要注意一点的是：</strong>
默认情况下，系统实际上并不会返回所有的数据，而是默认返回10条数据记录，你可以通过setLimit方法设置返回的记录数量。更多细节可<a href="http://docs.bmob.cn/data/JavaScript/b_developdoc/doc/index.html#分页查询">点击查看分页查询</a>一节。</p>
<h3 id="_10">获取对象的特殊属性<a class="headerlink" href="#_10" title="Permanent link">&para;</a></h3>
<p>注意，在对象中获取objectId，createdAt，updatedAt的方法分别如下：
obj.id
obj.createdAt
obj.updatedAt</p>
<h3 id="_11">查询单条数据<a class="headerlink" href="#_11" title="Permanent link">&para;</a></h3>
<p>当我们知道某条数据的<code>objectId</code>时，就可以根据<code>objectId</code>值直接获取单条数据对象，示例代码如下：</p>
<pre><code>var GameScore = Bmob.Object.extend(&quot;GameScore&quot;);
//创建查询对象，入口参数是对象类的实例
var query = new Bmob.Query(GameScore);
//查询单条数据，第一个参数是这条数据的objectId值
query.get(&quot;82c3e62d2c&quot;, {
  success: function(gameScore) {
    // 查询成功，调用get方法获取对应属性的值
    var score = gameScore.get(&quot;score&quot;);
    var playerName = gameScore.get(&quot;playerName&quot;);
    var cheatMode = gameScore.get(&quot;cheatMode&quot;);
  },
  error: function(object, error) {
    // 查询失败
  }
});
</code></pre>

<h3 id="_12">条件查询<a class="headerlink" href="#_12" title="Permanent link">&para;</a></h3>
<p>如果要查询某个属性等于某个值，示例代码如下：</p>
<pre><code>query.equalTo(&quot;playerName&quot;, &quot;bmob&quot;);
</code></pre>

<p>如果要查询某个属性不等于某个值，示例代码如下：</p>
<pre><code>query.notEqualTo(&quot;playerName&quot;, &quot;bmob cloud&quot;);
</code></pre>

<p>对查询的属性值进行大小比较的示例代码如下：</p>
<pre><code>// score &lt; 50
query.lessThan(&quot;score&quot;, 50);

// score &lt;= 50
query.lessThanOrEqualTo(&quot;score&quot;, 50);

// score &gt; 50
query.greaterThan(&quot;score&quot;, 50);

// score &gt;= 50
query.greaterThanOrEqualTo(&quot;score&quot;, 50);
</code></pre>

<p>两条查询语句一起写，就相当于<code>AND</code>查询，如下示例代码，查询同时满足<code>"playerName"="bmob" and "score"&gt;100</code>的数据：</p>
<pre><code>query.notEqualTo(&quot;playerName&quot;, &quot;bmob&quot;);
query.greaterThan(&quot;score&quot;, 100);
</code></pre>

<p>一个完整的例子：</p>
<pre><code>var GameScore = Bmob.Object.extend(&quot;GameScore&quot;);
var query = new Bmob.Query(GameScore);
query.equalTo(&quot;playerName&quot;, &quot;bmob&quot;); 
// 查询所有数据
query.find({
    success: function(results) {
        alert(&quot;共查询到 &quot; + results.length + &quot; 条记录&quot;);
        // 循环处理查询到的数据
        for (var i = 0; i &lt; results.length; i++) {
        var object = results[i];
        alert(object.id + ' - ' + object.get('playerName'));
        }
    },
    error: function(error) {
        alert(&quot;查询失败: &quot; + error.code + &quot; &quot; + error.message);
    }
});
</code></pre>

<h3 id="_13">分页查询<a class="headerlink" href="#_13" title="Permanent link">&para;</a></h3>
<p>有时，在数据比较多的情况下，你希望查询出的符合要求的所有数据能按照多少条为一页来显示，这时可以使用<code>limit</code>方法来限制查询结果的数据条数来进行分页。默认情况下，Limit的值为10，最大有效设置值1000（设置的数值超过1000还是视为1000）。</p>
<pre><code>// 返回最多10条数据
query.limit(10); 
</code></pre>

<p>在数据较多的情况下，在<code>limit</code>的基础上分页显示数据是比较合理的解决办法，<code>skip</code>方法可以做到跳过查询的前多少条数据来实现分页查询的功能。默认情况下<code>skip</code>的值为10。</p>
<pre><code>query.skip(10); // skip the first 10 results
</code></pre>

<h3 id="_14">结果排序<a class="headerlink" href="#_14" title="Permanent link">&para;</a></h3>
<p>我们可以对返回的结果进行排序（只支持<code>number</code>和<code>string</code>类型的排序），示例代码如下：</p>
<pre><code>// 对score字段升序排列
query.ascending(&quot;score&quot;);

// 对score字段降序排列
query.descending(&quot;score&quot;);
</code></pre>

<h3 id="_15">统计记录数量<a class="headerlink" href="#_15" title="Permanent link">&para;</a></h3>
<p>如果你只是想统计满足<code>query</code>的结果集到底有多条记录，你可以使用<code>count</code>方法。如为了获得GameScore表的记录数量，示例代码如下：</p>
<pre><code>var GameScore = Bmob.Object.extend(&quot;GameScore&quot;);
var query = new Bmob.Query(GameScore);
query.count({
  success: function(count) {
    // 查询成功，返回记录数量
    alert(&quot;共有 &quot; + count + &quot; 条记录&quot;);
  },
  error: function(error) {
    // 查询失败
  }
});

</code></pre>

<h3 id="_16">复杂查询<a class="headerlink" href="#_16" title="Permanent link">&para;</a></h3>
<p>如果你想查询某一字段值在某一集合中的记录的话，可以使用<code>containedIn</code>方法，如获取<code>"Bmob"、"Codenow"、"JS"</code>这三位玩家的记录信息，那么示例代码如下：</p>
<pre><code>// 第一个参数是字段名称，第二个参数是数组
query.containedIn(&quot;playerName&quot;, [&quot;Bmob&quot;, &quot;Codenow&quot;, &quot;JS&quot;]);

</code></pre>

<p>相反地，你可以使用<code>notContainedIn</code>方法来查询在集合外的目标对象。</p>
<p>如果想要查询含有某一特定属性的对象，可以使用<code>exists</code>。相对地，如果你想获取没有这一特定属性的对象，你可以使用<code>doesNotExist</code>，示例代码如下：</p>
<pre><code>// 查询含有score属性的对象
query.exists(&quot;score&quot;);

// 查询不含有score属性的对象
query.doesNotExist(&quot;score&quot;);
</code></pre>

<p>你可以使用<code>matchesKeyInQuery</code>方法来进行嵌套的子查询。举例说，如果你有一个类包含了运动队， 而你在用户类中存储了用户的家乡信息，你可以构造一个查询来查找某地的运动队有赢的记录的用户，示例代码如下：</p>
<pre><code>var Team = Bmob.Object.extend(&quot;Team&quot;);
var teamQuery = new Bmob.Query(Team);
teamQuery.greaterThan(&quot;winPct&quot;, 0.5);
var userQuery = new Bmob.Query(Bmob.User);
userQuery.matchesKeyInQuery(&quot;hometown&quot;, &quot;city&quot;, teamQuery);
userQuery.find({
  success: function(results) {
    // results has the list of users with a hometown team with a winning record
  }
});
</code></pre>

<p>相对地，可以使用<code>doesNotMatchKeyInQuery</code>来获取属性不在子查询结果中的对象。比如为了获得用户的家乡队输了的情况：</p>
<pre><code>var Team = Bmob.Object.extend(&quot;Team&quot;);
var teamQuery = new Bmob.Query(Team);
teamQuery.greaterThan(&quot;winPct&quot;, 0.5);
var userQuery = new Bmob.Query(Bmob.User);
userQuery.doesNotMatchKeyInQuery(&quot;hometown&quot;, &quot;city&quot;, teamQuery);
userQuery.find({
  success: function(results) {
    // results has the list of users with a hometown team with a winning record
  }
});
</code></pre>

<h3 id="_17">查询指定列<a class="headerlink" href="#_17" title="Permanent link">&para;</a></h3>
<p>有时候你不想返回所有的字段信息，那么就可以用<code>select</code>方法来限定返回的字段。示例代码如下：</p>
<pre><code>var GameScore = Bmob.Object.extend(&quot;GameScore&quot;);
var query = new Bmob.Query(GameScore);
// 只返回score和playerName字段值
query.select(&quot;score&quot;, &quot;playerName&quot;);
query.find().then(function(results) {
  // 返回成功
});
</code></pre>

<p><strong>注意：系统默认的字段<code>objectId</code>、<code>createdAt</code>、<code>updatedAt</code>、<code>ACL</code>也会返回。</strong></p>
<h3 id="_18">对字符串类型做查询<a class="headerlink" href="#_18" title="Permanent link">&para;</a></h3>
<p>如果想要查询以某一个特定字符串开头的记录，可以使用<code>startsWith</code>方法，示例代码如下：</p>
<pre><code>// 查询在playerName字段中以bm开头的记录
var query = new Bmob.Query(GameScore);
query.startsWith(&quot;playerName&quot;, &quot;bm&quot;);
</code></pre>

<h3 id="_19">或查询<a class="headerlink" href="#_19" title="Permanent link">&para;</a></h3>
<p>你可以使用<code>Bmob.Query.or</code>方法操作或查询，示例代码如下：</p>
<pre><code>var lotsOfWins = new Bmob.Query(GameScore);
lotsOfWins.greaterThan(&quot;score&quot;, 150);

var fewWins = new Bmob.Query(GameScore);
fewWins.lessThan(&quot;score&quot;, 5);

var mainQuery = Bmob.Query.or(lotsOfWins, fewWins);
mainQuery.find({
  success: function(results) {
     // 返回 score &gt; 150 or score &lt; 5 的值
  },
  error: function(error) {
    // 返回失败
  }
});
</code></pre>

<p><strong>注意：我们不会在组合查询的子查询中支持非过滤型的条件 (比如:limit,skip,ascending/descending,include)</strong></p>
<h2 id="_20">修改数据<a class="headerlink" href="#_20" title="Permanent link">&para;</a></h2>
<p>修改数据非常简单，首先需要获取到要更新的<code>Bmob.Object</code>对象，修改值后保存数据就可以了，示例代码如下：</p>
<pre><code>var GameScore = Bmob.Object.extend(&quot;GameScore&quot;);
var query = new Bmob.Query(GameScore);

// 这个 id 是要修改条目的 id，你在生成这个存储并成功时可以获取到，请看前面的文档
query.get('3453453453fdsdf', {
    success: function(gameScore) {
      // 回调中可以取得这个 GameScore 对象的一个实例，然后就可以修改它了
      gameScore.set('title', 'test!');
      gameScore.save();

      // The object was retrieved successfully.
    },
    error: function(object, error) {

    }
});
</code></pre>

<p>或者</p>
<pre><code>var GameScore = Bmob.Object.extend(&quot;GameScore&quot;);
var gameScore = new GameScore();
gameScore.set(&quot;cheatMode&quot;, true);
gameScore.set(&quot;score&quot;, 1338);
//添加数据
gameScore.save(null, {
  success: function(gameScore) {
    // 修改数据
    gameScore.set(&quot;cheatMode&quot;, true);
    gameScore.set(&quot;score&quot;, 1338);
    gameScore.save();
  }
})
</code></pre>

<p>如果想更新成功后获取更新后的对象属性，请设置<code>fetchWhenSave</code>：</p>
<pre><code> //假设gamescore是已经存在的对象
    gameScore.fetchWhenSave(true);
    gameScore.set(&quot;cheatMode&quot;, true);
    gameScore.set(&quot;score&quot;, 1338);
    gameScore.save();
</code></pre>

<h2 id="_21">删除数据<a class="headerlink" href="#_21" title="Permanent link">&para;</a></h2>
<p>删除数据可以使用<code>Bmob.Object</code>的<code>destroy</code>方法，示例代码如下：</p>
<pre><code>myObject.destroy({
  success: function(myObject) {
    // 删除成功
  },
  error: function(myObject, error) {
    // 删除失败
  }
});

</code></pre>

<h3 id="_22">删除字段<a class="headerlink" href="#_22" title="Permanent link">&para;</a></h3>
<p>你可以使用<code>unset</code>方法在删除一个字段：</p>
<pre><code>// 删除playerName字段
myObject.unset(&quot;playerName&quot;);
myObject.save();
</code></pre>

<h2 id="_23">常见数据类型的操作<a class="headerlink" href="#_23" title="Permanent link">&para;</a></h2>
<pre><code>var number = 42;
var string = &quot;the number is &quot; + number;
var date = new Date();
var array = [string, number];
var object = { number: number, string: string };

var bigObject = new BigObject();
bigObject.set(&quot;myNumber&quot;, number);
bigObject.set(&quot;myString&quot;, string);
bigObject.set(&quot;myDate&quot;, date);
bigObject.set(&quot;myArray&quot;, array);
bigObject.set(&quot;myObject&quot;, object);
bigObject.set(&quot;myNull&quot;, null);
bigObject.save();
</code></pre>

<h2 id="_24">数组操作<a class="headerlink" href="#_24" title="Permanent link">&para;</a></h2>
<h3 id="_25">添加及更新数组<a class="headerlink" href="#_25" title="Permanent link">&para;</a></h3>
<p>为了帮你存储数组类数据，有三种操作你可以原子性地改动一个数组，这需要一个给定的 key：</p>
<ul>
<li><code>add</code>在一个数组的末尾加入一个给定的对象。</li>
<li><code>addUnique</code>只会把原本不存在的对象加入数组，所以加入的位置没有保证。</li>
</ul>
<p>比如, 我们想在数组"skills"中加入项目：</p>
<pre><code>gameScore.addUnique(&quot;skills&quot;, &quot;flying&quot;);
gameScore.addUnique(&quot;skills&quot;, &quot;kungfu&quot;);
gameScore.save();
</code></pre>

<h3 id="_26">数组查询<a class="headerlink" href="#_26" title="Permanent link">&para;</a></h3>
<p>对于value是数组的情况，你可以这样查询数组中的值有<code>2</code>的情况的对象：</p>
<pre><code>// Find objects where the array in arrayKey contains 2.
query.equalTo(&quot;arrayKey&quot;, 2);
</code></pre>

<p>你同样可以用下面的方式找到同时包含元素<code>2、3、4</code>的数组：</p>
<pre><code>// Find objects where the array in arrayKey contains all of the elements 2, 3, and 4.
query.containsAll(&quot;arrayKey&quot;, [2, 3, 4]);
</code></pre>

<h3 id="_27">删除数组<a class="headerlink" href="#_27" title="Permanent link">&para;</a></h3>
<p><code>remove</code>在一个数组中删除所有指定的所有实例：</p>
<pre><code>var GameScoretest = Bmob.Object.extend(&quot;GameScoretest&quot;);
var query = new Bmob.Query(GameScoretest);
query.get(&quot;bc5da708dc&quot;,{
  success: function(gameScore) {
    gameScore.remove(&quot;skills&quot;,&quot;test&quot;);
    gameScore.save();
  },
  error: function(error) {
    alert(&quot;Error: &quot; + error.code + &quot; &quot; + error.message);
  }
}); 
</code></pre>

<h2 id="_28">数据关联<a class="headerlink" href="#_28" title="Permanent link">&para;</a></h2>
<h3 id="_29">添加及修改关联关系<a class="headerlink" href="#_29" title="Permanent link">&para;</a></h3>
<h4 id="_30">一对一关系和一对多关系<a class="headerlink" href="#_30" title="Permanent link">&para;</a></h4>
<p>一对一关系和一对多关系都可以通过在一个<code>Bmob.Object</code>内保存另一个对象来实现。比如，每一个 Comment都对应了一个Post，创建一个有一个Comment的Post，你可以这样写：</p>
<pre><code>// Declare the types.
var Post = Bmob.Object.extend(&quot;Post&quot;);
var Comment = Bmob.Object.extend(&quot;Comment&quot;);

// Create the post
var myPost = new Post();
myPost.set(&quot;title&quot;, &quot;I'm Hungry&quot;);
myPost.set(&quot;content&quot;, &quot;Where should we go for lunch?&quot;);

// Create the comment
var myComment = new Comment();
myComment.set(&quot;content&quot;, &quot;Let's do Sushirrito.&quot;);

// Add the post as a value in the comment
myComment.set(&quot;parent&quot;, myPost);

// This will save both myPost and myComment
myComment.save();
</code></pre>

<p>Bmob内部会自动处理，调用Comment的<code>save</code>方法就可以同时保存两个新对象。</p>
<p>如果是现有对象想要关联到新对象，你同样可以通过只用它们的<code>objectId</code>来连接彼此。请注意，不能直接像上面的例子那样将现有对象设置进去，而是必须<code>new</code>一个新对象并只设置<code>id</code>属性：</p>
<pre><code>var post = Bmob.Object.createWithoutData(&quot;Post&quot;, &quot;320b0395f3&quot;);
myComment.set(&quot;parent&quot;, post);
</code></pre>

<p>或者：</p>
<pre><code>var post = new Post();
post.id = '520c7e1ae4b0a3ac9ebe326a';
myComment.set(&quot;parent&quot;, post);
</code></pre>

<p>默认情况下，当获取一个对象时，关联的<code>Bmob.Object</code>不会被获取到，这些对象的值不能访问，除非像下面这样获取它们：</p>
<pre><code>var post = fetchedComment.get(&quot;parent&quot;);
post.fetch({
  success: function(post) {
    var title = post.get(&quot;title&quot;);
  }
});
</code></pre>

<h4 id="_31">多对多关系<a class="headerlink" href="#_31" title="Permanent link">&para;</a></h4>
<p>多对多关系是通过<code>Bmob.Relation</code>来建模的，这样很像在一个key中存储一个<code>Bmob.Object</code>数组，但是你不需要一次性下载关系中的所有对象。这使得<code>Bmob.Relation</code>比数组可以更好地扩展到更多对象。例如，一个User可能喜欢很多Post，在这种情况下，你可以把一个用户喜欢的所有Post存为一个Relation，为了将一个Post加入一个User的like列表，你可以：</p>
<pre><code>var user = Bmob.User.current();
var relation = user.relation(&quot;likes&quot;);
relation.add(post);
user.save();
</code></pre>

<p>你还可以传入一个<code>Bmob.Object</code>数组来做<code>add</code>和<code>remove</code>：</p>
<pre><code>relation.add([post1, post2, post3]);
user.save();
</code></pre>

<h3 id="_32">查询关联关系<a class="headerlink" href="#_32" title="Permanent link">&para;</a></h3>
<p>默认情况下，<code>relation</code>关联的对象并不会被下载，你可以通过使用<code>query</code>方法返回的<code>Bmob.Query</code>对象来获取<code>Bmob.Object</code>的列表，例如：</p>
<pre><code>relation.query().find({
  success: function(list) {
    // list contains the posts that the current user likes.
  }
});
</code></pre>

<p>如果你仅仅要一个Post的子集，你可以在<code>Bmob.Query</code>中加入更多的条件：</p>
<pre><code>var query = relation.query();
query.equalTo(&quot;title&quot;, &quot;I'm Hungry&quot;);
query.find({
  success:function(list) {
    // list contains post liked by the current user which have the title &quot;I'm Hungry&quot;.
  }
});
</code></pre>

<p>如果希望查询结果中包含多个相关联的其他数据类型。你可以使用 include 方 法。例如有个comments，你可能想同时获取它们相关的 post 数据:</p>
<pre><code>var query = new Bmob.Query(Comment);

query.include(&quot;post&quot;);
</code></pre>

<p>你可以在接下来关于<code>Bmob.Query</code>的章节中看到更详细的内容。一个<code>Bmob.Relation</code>的行为很像一个<code>Bmob.Object</code>数组，所以任何在数组可做的查询操作，也都可以作用在<code>Bmob.Relation</code>上。</p>
<p>如果你知道post，想反向查询user，可以通过<code>Bmob.Relation.reverseQuery</code>方法：</p>
<pre><code>var query = Bmob.Relation.reverseQuery('_User', 'likes', post);
query.find({
  success:function(users) {
   //users是表示喜欢这个post的用户列表。
  }
});
</code></pre>

<h3 id="_33">删除关联关系<a class="headerlink" href="#_33" title="Permanent link">&para;</a></h3>
<p>你可以从一个<code>Bmob.Relation</code>中删除一个post：</p>
<pre><code>relation.remove(post);
user.save();
</code></pre>

<p>你可以在用<code>save</code>方法保存前多次调用<code>add</code>和<code>remove</code>方法：</p>
<pre><code>relation.remove(post1);
relation.remove(post2);
user.save();
</code></pre>

<h2 id="_34">原子计数器<a class="headerlink" href="#_34" title="Permanent link">&para;</a></h2>
<p>许多应用都需要维持一些计数器数据，譬如用来跟踪游戏分数、金币甚至道具的数目等等。Bmob提供了便捷的方式来对任何数字字段进行原子性的增加或者减少：</p>
<pre><code>gameScore.increment(&quot;score&quot;);
gameScore.save();
</code></pre>

<p>你可以同样传入第二个参数到<code>increment</code>方法来指定增加多少，<code>1</code>是默认值。</p>
<h2 id="_35">文件<a class="headerlink" href="#_35" title="Permanent link">&para;</a></h2>
<h3 id="_36">整个文件上传<a class="headerlink" href="#_36" title="Permanent link">&para;</a></h3>
<p>上传文件有两种方法：</p>
<p>直接上传文件，例如，我们上传一个内容为"Hello, World!"，名称为"hello.txt"的文件，可用如下的代码：</p>
<pre><code>var bytes = &quot;Hello, World!&quot;;
var file = new Bmob.File(&quot;hello.txt&quot;, bytes);
file.save().then(function(obj) {
  //alert(obj.url());
}, function(error) {
  // the save failed.
});
</code></pre>

<p>最经常的对于HTML5的应用来说，可能需要用html表单和一个文件上传控制器。在现代的浏览器中这很容易，只需要创建一个file input tag来允许用户选择他们磁盘上的文件就可以了。</p>
<pre><code>&lt;input type=&quot;file&quot; id=&quot;profilePhotoFileUpload&quot;&gt;
</code></pre>

<p>然后，在一个处理<code>click</code>或其他的函数里，获取对那个文件的一个引用：</p>
<pre><code>        var fileUploadControl = $(&quot;#profilePhotoFileUpload&quot;)[0];
        if (fileUploadControl.files.length &gt; 0) {
        var file = fileUploadControl.files[0];
        var name = &quot;logo.jpg&quot;;
        var file = new Bmob.File(name, file);     
        file.save();
</code></pre>

<h3 id="_37">文件删除<a class="headerlink" href="#_37" title="Permanent link">&para;</a></h3>
<pre><code>  file.destroy(); //删除文件

</code></pre>

<h2 id="_38">图片处理<a class="headerlink" href="#_38" title="Permanent link">&para;</a></h2>
<p>提供一些工具接口，方便开发者处理图片。</p>
<h3 id="_39">缩微图<a class="headerlink" href="#_39" title="Permanent link">&para;</a></h3>
<p>提供原图的URL地址和相应的参数， 返回缩微图的URL地址， 具体参数定义如下：</p>
<pre><code>mode:模式 0: 指定宽， 高自适应，等比例缩放
     模式 1: 指定高， 宽自适应，等比例缩放
     模式 2: 指定最长边，短边自适应，等比例缩放
     模式 3: 指定最短边，长边自适应，等比例缩放
     模式 4: 指定最大宽高， 等比例缩放
     模式 5: 固定宽高， 居中裁剪    
image:原图片url
width:宽度，模式 0, 4, 5必填
height：高度，模式 1, 4, 5必填
longEdge：长边，模式 2必填
shortEdge：短边，模式 3必填
quality：质量，选填, 范围 1-100
outType：输出类型，0:默认，输出url；1:输出base64编码的字符串流
</code></pre>

<p>调用的代码：</p>
<pre><code>Bmob.Image.thumbnail({&quot;image&quot;:&quot;http://file.bmob.cn/M00/01/26/wKgBP1OX9LLVh5gNAAHGYsmKRjk666.jpg&quot;,&quot;mode&quot;:0,&quot;quality&quot;:100,&quot;width&quot;:100}

  ).then(function(obj) {

  alert(&quot;filename:&quot;+obj.filename); //
  alert(&quot;url:&quot;+obj.url); //
});

</code></pre>

<p>如果<code>outType = 0</code>返回云端url地址:</p>
<pre><code>{
  &quot;filename&quot;: &quot;e6c8ac18c9.jpg&quot;,
  &quot;group&quot;: &quot;group1&quot;,
  &quot;url&quot;: &quot;M00/01/6E/wKhkA1OGpWKAGdNUAAAjdkbUqo4612.jpg&quot;
}
</code></pre>

<p>如果 <code>outType = 1</code> 返回文件内容的 base64 字符串：</p>
<pre><code>{
  &quot;file&quot;:&quot;base64的文件内容&quot;
}
</code></pre>

<h3 id="_40">水印图<a class="headerlink" href="#_40" title="Permanent link">&para;</a></h3>
<p>提供原图的URL地址，水印图的URL地址和相应的参数，返回缩微图的URL地址，具体参数定义如下：</p>
<pre><code>image：原图路径
watermark：水印图路径
dissolve:透明度，0-255
distanceX：横轴边距，单位:像素(px)，缺省值为10
distanceY：纵轴边距，单位:像素(px)，缺省值为10
outType：输出类型，0:默认，输出url；1:输出base64编码的字符串流
gravity:水印位置，见下图
</code></pre>

<p><img alt="" src="../image/anchor.png" /></p>
<p>调用的代码：</p>
<pre><code>//get image thumbnail
Bmob.Image.watermark({&quot;image&quot;:&quot;http://test.com/new/images/banner005.jpg&quot;,&quot;watermark&quot;:&quot;http://test.com/new/images/header2.png&quot;,&quot;dissolve&quot;:100,&quot;gravity&quot;:&quot;SouthWest&quot;,&quot;distanceX&quot;:10,&quot;distanceY&quot;:10}

  ).then(function(obj) {

  alert(&quot;filename:&quot;+obj.filename); //
  alert(&quot;url:&quot;+obj.url); //
});

</code></pre>

<p>如果 <code>outType = 0</code> 返回云端url地址:</p>
<pre><code>{
  &quot;filename&quot;: &quot;e6c8ac18c9.jpg&quot;,
  &quot;group&quot;: &quot;group1&quot;,
  &quot;url&quot;: &quot;M00/01/6E/wKhkA1OGpWKAGdNUAAAjdkbUqo4612.jpg&quot;
}
</code></pre>

<p>如果 <code>outType = 1</code> 返回文件内容的 base64 字符串：</p>
<pre><code>{
  &quot;file&quot;:&quot;base64的文件内容&quot;
}
</code></pre>

<h2 id="promise">Promise<a class="headerlink" href="#promise" title="Permanent link">&para;</a></h2>
<p>除了回调函数之外，每一个在Bmob JavaScript SDK中的异步方法都会返回一个 Promise. 使用 Promise，你的代码可以比原来的嵌套 callback 的方法看起来优雅得多.</p>
<h3 id="then">then 方法<a class="headerlink" href="#then" title="Permanent link">&para;</a></h3>
<p>每一个<code>Promise</code>都有一个叫<code>then</code>的方法, 这个方法接受一对<code>callback</code>。第一个<code>callback</code>在<code>promise</code>被解决的时候调用，第二个会在<code>promise</code>被拒绝的时候调用。</p>
<pre><code>obj.save().then(function(obj) {
  // the object was saved successfully.
}, function(error) {
  // the save failed.
});
</code></pre>

<h3 id="promise_1">将Promise 组织在一起<a class="headerlink" href="#promise_1" title="Permanent link">&para;</a></h3>
<p><code>Promise</code>比较神奇，可以代替多层嵌套方式来解决发送异步请求代码的调用顺序问题。 如果一个<code>Promise</code>的回调会返回一个<code>Promise</code>，那么第二个<code>then</code>里的<code>callback</code>在第一个<code>then</code>的<code>callback</code>没有解决前是不会解决的。</p>
<pre><code>var query = new Bmob.Query(&quot;Student&quot;);
query.descending(&quot;gpa&quot;);
query.find().then(function(students) {
  students[0].set(&quot;valedictorian&quot;, true);
  return students[0].save();

}).then(function(valedictorian) {
  return query.find();

}).then(function(students) {
  students[1].set(&quot;salutatorian&quot;, true);
  return students[1].save();

}).then(function(salutatorian) {
  // Everything is done!

});
</code></pre>

<h3 id="_41">错误处理<a class="headerlink" href="#_41" title="Permanent link">&para;</a></h3>
<p>如果任意一个在链中的<code>Promise</code>返回一个错误的话，所有的成功的<code>callback</code>在接下来都会被跳过直到遇到一个处理错误的<code>callback</code>。处理<code>error</code>的<code>callback</code>可以转换<code>error</code>或者可以通过返回一个新的<code>Promise</code>的方式来处理它。你可以想象成拒绝的<code>promise</code>有点像异常，而<code>error callback</code>则像是一个<code>catch</code>来处理这个异常或者抛出异常。</p>
<pre><code>var query = new Bmob.Query(&quot;Student&quot;);
query.descending(&quot;gpa&quot;);
query.find().then(function(students) {
  students[0].set(&quot;valedictorian&quot;, true);
  // Force this callback to fail.
  return Bmob.Promise.error(&quot;There was an error.&quot;);

}).then(function(valedictorian) {
  // Now this will be skipped.
  return query.find();

}).then(function(students) {
  // This will also be skipped.
  students[1].set(&quot;salutatorian&quot;, true);
  return students[1].save();
}, function(error) {
  // This error handler WILL be called. error will be &quot;There was an error.&quot;.
  // Let's handle the error by returning a new promise.
  return Bmob.Promise.as(&quot;Hello!&quot;);

}).then(function(hello) {
  // Everything is done!
}, function(error) {
  // This isn't called because the error was already handled.
});
</code></pre>

<p>通常来说，在正常情况的回调函数链的末尾，加一个错误处理的回调函数会是很方便的做法.</p>
<h3 id="promise_2">创建 Promise<a class="headerlink" href="#promise_2" title="Permanent link">&para;</a></h3>
<p>在开始阶段，你可以只用系统（譬如<code>find</code>和<code>save</code>方法等）返回的<code>promise</code>。但在更高级的场景下，你可能需要创建自己的<code>promise</code>。在创建了<code>Promise</code>之后，你需要调用<code>resolve</code>或者<code>reject</code>来触发它的<code>callback</code>。</p>
<pre><code>var successful = new Bmob.Promise();
successful.resolve(&quot;The good result.&quot;);

var failed = new Bmob.Promise();
failed.reject(&quot;An error message.&quot;);
</code></pre>

<p>如果你在创建<code>promise</code>的时候就知道它的结果，下面有两个很方便的方法可以使用：</p>
<pre><code>var successful = Bmob.Promise.as(&quot;The good result.&quot;);
var failed = Bmob.Promise.error(&quot;An error message.&quot;);
</code></pre>

<h3 id="promise_3">顺序的Promise<a class="headerlink" href="#promise_3" title="Permanent link">&para;</a></h3>
<pre><code>var query = new Bmob.Query(&quot;Comments&quot;);
query.equalTo(&quot;post&quot;, 123);

query.find().then(function(results) {
  // Create a trivial resolved promise as a base case.
  var promise = Bmob.Promise.as();
  _.each(results, function(result) {
    // For each item, extend the promise with a function to delete it.
    promise = promise.then(function() {
      // Return a promise that will be resolved when the delete is finished.
      return result.destroy();
    });
  });
  return promise;

}).then(function() {
  // Every comment was deleted.
});
</code></pre>

<h3 id="promise_4">并行的Promise<a class="headerlink" href="#promise_4" title="Permanent link">&para;</a></h3>
<p>你也可以用<code>Promise</code>来并行的进行多个任务，这时需要使用<code>when</code>方法。你可以一次同时开始几个操作，使用<code>Bmob.Promise.when</code>来创建一个新的<code>promise</code>，它会在所有输入的<code>Promise</code>被解决之后才被解决。即便一些输入的<code>promise</code>失败了，新的<code>Promise</code>也会被成功执行。你可以在 <code>callback</code>的参数部分检查每一个<code>promise</code>的结果，并行地进行操作会比顺序进行更快，但是也会消耗更多的系统资源和带宽。</p>
<pre><code>var query = new Bmob.Query(&quot;Comments&quot;);
query.equalTo(&quot;post&quot;, 123);

query.find().then(function(results) {
  // Collect one promise for each delete into an array.
  var promises = [];
  _.each(results, function(result) {
    // Start this delete immediately and add its promise to the list.
    promises.push(result.destroy());
  });
  // Return a new promise that is resolved when all of the deletes are finished.
  return Bmob.Promise.when(promises);

}).then(function() {
  // Every comment was deleted.
});
</code></pre>

<h3 id="_42">创建异步方法<a class="headerlink" href="#_42" title="Permanent link">&para;</a></h3>
<p>有了上面这些工具以后, 就很容易创建你自己的异步方法来返回<code>promise</code>了。举例说，你可以创建一个有<code>promise</code>版本的<code>setTimeout</code>。</p>
<pre><code>var delay = function(millis) {
  var promise = new Bmob.Promise();
  setTimeout(function() {
    promise.resolve();
  }, millis);
  return promise;
};

delay(100).then(function() {
  // This ran after 100ms!
});
</code></pre>

<h2 id="collection">Collection<a class="headerlink" href="#collection" title="Permanent link">&para;</a></h2>
<p>一个<code>Bmob.Collection</code>就是一个<code>Bmob.Objects</code>的有序集合，它和<code>Backbone.Collection</code>是兼容的，有相同的特性和功能，你可以通过用一个模型类或者一个特定的<code>Bmob.Query</code>来创建一个新的子类。</p>
<pre><code>// A Collection containing all instances of TestObject.
var TestCollection = Bmob.Collection.extend({
  model: TestObject
});
var collection = new TestCollection();

// A Collection of TestObjects whose temperature is &quot;hot&quot;.
var HotCollection = Bmob.Collection.extend({
  model: TestObject,
  query: (new Bmob.Query(TestObject)).equalTo(&quot;temperature&quot;, &quot;hot&quot;)
});
var collection = new HotCollection();

// The Collection of TestObjects that match a complex query.
var query = new Bmob.Query(TestObject);
query.equalTo(&quot;temperature&quot;, &quot;hot&quot;);
query.greaterThan(&quot;degreesF&quot;, 100);
var collection = query.collection();
</code></pre>

<h3 id="collection_1">获取Collection<a class="headerlink" href="#collection_1" title="Permanent link">&para;</a></h3>
<p>使用<code>fetch</code>方法来获取一个<code>collection</code>里的所有元素:</p>
<pre><code>var collection = new TestCollection();
collection.fetch({
  success: function(collection) {
    collection.each(function(object) {
      console.warn(object);
    });
  },
  error: function(collection, error) {
    // The collection could not be retrieved.
  }
});
</code></pre>

<h3 id="collection_2">Collection 排序<a class="headerlink" href="#collection_2" title="Permanent link">&para;</a></h3>
<p>你可以设定一个<code>comparator</code>来对<code>collection</code>中的元素进行排序:</p>
<pre><code>var collection = new TestCollection();
collection.comparator = function(object) {
  return object.get(&quot;temperature&quot;);
};
</code></pre>

<h3 id="collection_3">修改一个 Collection<a class="headerlink" href="#collection_3" title="Permanent link">&para;</a></h3>
<p><code>Collection</code>是可变的，你可以访问所有元素，增加或者删除元素：</p>
<pre><code>var collection = new TestCollection();

collection.add([
  {&quot;name&quot;: &quot;Duke&quot;},
  {&quot;name&quot;: &quot;Scarlett&quot;}
]);

// Get the &quot;Duke&quot; Bmob.Object by its sorted position.
var model = collection.at(0);

// Or you can get it by Bmob objectId.
var modelAgain = collection.get(model.id);

// Remove &quot;Duke&quot; from the collection.
collection.remove(model);

// Completely replace all items in the collection.
collection.reset([
  {&quot;name&quot;: &quot;Hawk&quot;},
  {&quot;name&quot;: &quot;Jane&quot;}
]);
</code></pre>

<h2 id="_43">用户<a class="headerlink" href="#_43" title="Permanent link">&para;</a></h2>
<p>在许多应用中，都有一个用户账户的概念，用户账户让用户可以用安全的方式访问他们自己的信息。我们提供了一个特殊的用户类叫<code>Bmob.User</code>来自动处理有关用户的账户管理的功能。</p>
<p><code>Bmob.User</code>是<code>Bmob.Object</code>的一个子类，而且有<code>Bmob.Object</code>一样的功能，比如可变的模式、自动的持久化、键值对接口等。所有对<code>Bmob.Object</code>有用的方法同样可以作用于<code>Bmob.User</code>。<code>Bmob.User</code>的不同之处在于<code>Bmob.User</code>对于用户的账户有一些特定的功能。</p>
<h3 id="_44">属性<a class="headerlink" href="#_44" title="Permanent link">&para;</a></h3>
<p><code>Bmob.User</code>有一些与<code>Bmob.Object</code>不一样的字段:</p>
<p><code>username</code>：用户的用户名（必须提供）
<code>password</code>：用户的密码（在注册的时候必须提供）
<code>email</code>：用户的 email（可选）
我们会在下面的用例中详细介绍细节</p>
<h3 id="_45">注册<a class="headerlink" href="#_45" title="Permanent link">&para;</a></h3>
<p>通常你的app第一件要做的事情就是让用户进行注册，下面的代码展示了怎样进行通常的注册过程：</p>
<pre><code>var user = new Bmob.User();
user.set(&quot;username&quot;, &quot;my name&quot;);
user.set(&quot;password&quot;, &quot;my pass&quot;);
user.set(&quot;email&quot;, &quot;email@example.com&quot;);

// other fields can be set just like with Bmob.Object
user.set(&quot;phone&quot;, &quot;415-392-0202&quot;);

user.signUp(null, {
  success: function(user) {
    // Hooray! Let them use the app now.
  },
  error: function(user, error) {
    // Show the error message somewhere and let the user try again.
    alert(&quot;Error: &quot; + error.code + &quot; &quot; + error.message);
  }
});
</code></pre>

<p>这个调用会异步地在在你的应用中创建一个新的用户。在它这样做之前，它同样会确认用户名和<code>email</code>在应用内都是唯一的。同样，我们从不会将用户密码以明文向任何客户端发送。</p>
<p>注意我们使用了<code>signUp</code>方法而不是<code>save</code>方法，新的<code>Bmob.User</code>永远应该使用<code>signUp</code>方法来新建。而随后的用户的信息更新可以调用<code>save</code>来做。</p>
<p>如果一个<code>signup</code>没有成功的话，你应该读取返回的错误对象。最常见的问题是<code>username</code>或者<code>email</code>已经被其他用户所使用了。你应该清楚地反馈给你的用户，让他们再次用一个不同的用户名来注册。</p>
<p>你也可以使用<code>email</code>来作为用户名，只要求你的用户输入他们的<code>email</code>但是同时自动填充好<code>username</code>属性就可以了，<code>Bmob.User</code>会跟原来一样工作，我们会在下面的重设密码环节再次说明这个细节。</p>
<h3 id="_46">登录<a class="headerlink" href="#_46" title="Permanent link">&para;</a></h3>
<p>在你要求你的用户注册之后，当然应该让他们在以后用自己的账户登录进来，你可以使用<code>logIn</code>方法来进行登陆：</p>
<pre><code>Bmob.User.logIn(&quot;myname&quot;, &quot;mypass&quot;, {
  success: function(user) {
    // Do stuff after successful login.
  },
  error: function(user, error) {
    // The login failed. Check error to see why.
  }
});
</code></pre>

<h3 id="email">验证 Email<a class="headerlink" href="#email" title="Permanent link">&para;</a></h3>
<p>在application设置中启用email验证可以让你的应用给最终用户一些更安全的使用体验，譬如部分功能只开放给验证过邮箱的用户使用等等。Email验证会在<code>Bmob.User</code>上加入一个<code>emailVerified</code>字段。当一个<code>Bmob.User</code>的<code>email</code>被设定或者修改后,<code>emailVerfied</code>会被设定为<code>false</code>。Bmob 会向用户的<code>email</code>来发送一个链接，点击这个链接会设置<code>emailVerified</code>为<code>true</code>：</p>
<p>有三种<code>emailVerified</code>状态可以供参考：</p>
<ol>
<li><code>true</code>：用户已经通过点击Bmob发过来的链接来确认邮箱地址. 当用户账户新创建的时候这个值永远不应该是true。</li>
<li><code>false</code>：在 <code>Bmob.User</code>对象最后一次刷新的时候，用户还是没有确认他们的<code>email</code>地址，如果<code>emailVerified</code>是false 的话，你应该考虑调用<code>Bmob.User</code>的<code>fetch</code>方法。</li>
<li><code>missing</code>：<code>Bmob.User</code>被创建了，但是当时的<code>email</code>验证功能还没有开启, 或者说<code>Bmob.User</code>没有email地址。</li>
</ol>
<p>代码例子如下：</p>
<pre><code>//reset password
 Bmob.User.requestEmailVerify(&quot;h6k65@126.com&quot;, {
  success: function() {
    // Password reset request was sent successfully
  },
  error: function(error) {
    // Show the error message somewhere
    alert(&quot;Error: &quot; + error.code + &quot; &quot; + error.message);
  }
});
</code></pre>

<h3 id="_47">当前用户<a class="headerlink" href="#_47" title="Permanent link">&para;</a></h3>
<p>如果用户每次打开App的时候都要求登录无疑是令人感到厌烦的，你可以通过缓存当前的<code>Bmob.User</code>对象来避免这个问题。</p>
<p>无论你使用任何注册或者登录方法，用户都会在<code>localStorage</code>中储存，你可以把缓存作为一个<code>session</code>对待，并且自动假设用户已经登录了。</p>
<pre><code>var currentUser = Bmob.User.current();
if (currentUser) {
    // do stuff with the user
} else {
    // show the signup or login page
}
</code></pre>

<p>你可以通过<code>logout</code>来清除掉当前的用户：</p>
<pre><code>Bmob.User.logOut();

var currentUser = Bmob.User.current();  // this will now be null
</code></pre>

<h3 id="_48">用户对象的安全<a class="headerlink" href="#_48" title="Permanent link">&para;</a></h3>
<p><code>Bmob.User</code>类默认就是受保护的，在<code>Bmob.User</code>中保存的数据只能被那个用户所修改。默认地，数据仍然可以被任意客户端所读取。这样就是说，有些<code>Bmob.User</code>对象被认证后是可以修改的，其他的仍然是只读的。</p>
<p>特别的，你不能调用<code>save</code>或者<code>delete</code>方法除非<code>Bmob.User</code>经过了认证，就比如调用过了<code>logIn</code>或者<code>signUp</code>方法，这样保证只有用户能改动他们自身的数据。</p>
<p>下面的代码展示了上面说的安全策略：</p>
<pre><code>var user = Bmob.User.logIn(&quot;my_username&quot;, &quot;my_password&quot;, {
  success: function(user) {
    user.set(&quot;username&quot;, &quot;my_new_username&quot;);  // attempt to change username
    user.save(null, {
      success: function(user) {
        // This succeeds, since the user was authenticated on the device

        // Get the user from a non-authenticated method
        var query = new Bmob.Query(Bmob.User);
        query.get(user.objectId, {
          success: function(userAgain) {
            userAgain.set(&quot;username&quot;, &quot;another_username&quot;);
            userAgain.save(null, {
              error: function(userAgain, error) {
                // This will error, since the Bmob.User is not authenticated
              }
            });
          }
        });
      }
    });
  }
});
</code></pre>

<p>从<code>Bmob.User.current()</code>获取的<code>Bmob.User</code>总是已经通过验证了的。</p>
<p>如果你需要查看一个<code>Bmob.User</code>是否已经认证过了，你可以调用<code>authenticated</code>方法，你不需要查看一个认证方法中返回的<code>Bmob.User</code>对象是否已经通过验证了。</p>
<h3 id="_49">其他对象的安全<a class="headerlink" href="#_49" title="Permanent link">&para;</a></h3>
<p>和<code>Bmob.User</code>相同的安全模型也使用于其他对象。对于任何对象来说，你可以指定哪些用户会被允许读取对象，哪些用户被允许修改对象。为了支持这种安全机制，每一个对象都有一个允许访问列表 (ACL)，是被<code>Bmob.ACL</code>类所实现的。</p>
<p>使用一个<code>Bmob.ACL</code>最简单的方式是指定一个对象只能被一个单一的用户读或者写。为了创建这样的对象，首先必须有一个已经登录的<code>Bmob.User</code>。然后，新的<code>Bmob.ACL(user)</code>生成一个<code>Bmob.ACL</code>来限定<code>user</code>的访问。一个对象的ACL会在对象保存的时候被存储起来，就像其他的属性一样，这样，为了创建一个当前user私有的一个note：</p>
<pre><code>var Note = Bmob.Object.extend(&quot;Note&quot;);
var privateNote = new Note();
privateNote.set(&quot;content&quot;, &quot;This note is private!&quot;);
privateNote.setACL(new Bmob.ACL(Bmob.User.current()));
privateNote.save();
</code></pre>

<p>这个note只能由当前的用户所访问，但是可以在用户登录的任何设备上访问，只要是相同的用户就可以了。这项功能对于你如果想让用户再任何其他的设备上保存和访问数据十分有用，比如说一个私人的todo list应用。</p>
<p>权限也能在使用者的基础上授予，你可以通过<code>setReadAccess</code>和<code>setWriteAccess</code>方法独立的向<code>Bmob.ACL</code>中添加权限。比如，假设你有一条消息想要发送给一个组里的多个用户，他们中的每一个都有读和写的权限：</p>
<pre><code>var Message = Bmob.Object.extend(&quot;Message&quot;);
var groupMessage = new Message();
var groupACL = new Bmob.ACL();

// userList is an array with the users we are sending this message to.
for (var i = 0; i &lt; userList.length; i++) {
  groupACL.setReadAccess(userList[i], true);
  groupACL.setWriteAccess(userList[i], true);
}

groupMessage.setACL(groupACL);
groupMessage.save();
</code></pre>

<p>你同样可以对所有的用户授权，只要使用<code>setPublicReadAccess</code>和<code>setPublicWriteAccess</code>就可以了。这样允许了在一个消息板上发评论的模式，比如，我们要创建一个post只能被它的作者修改，但是可以被所有人读取：</p>
<pre><code>var publicPost = new Post();
var postACL = new Bmob.ACL(Bmob.User.current());
postACL.setPublicReadAccess(true);
publicPost.setACL(postACL);
publicPost.save();
</code></pre>

<p>比如说删除一个对象，但是你没有写的权限这种操作是禁止的，这样会返回一个<code>Bmob.Error.OBJECT_NOT_FOUND</code>的错误码，为了安全起见，这样防止了客户端区分出到底有哪些对象被创建了但是无法读取还是根本不存在。</p>
<h3 id="_50">重设密码<a class="headerlink" href="#_50" title="Permanent link">&para;</a></h3>
<p>在现实中只要你引入了密码系统，总会有用户会忘掉他们的密码。在这种情形下，我们的库提供一个让他们安全地重设密码的功能。</p>
<p>为了能让用户重设密码，应该要求用户提供他们的email地址，然后这样调用：</p>
<pre><code> Bmob.User.requestPasswordReset(&quot;test@126.com&quot;, {
  success: function() {
    // Password reset request was sent successfully
  },
  error: function(error) {
    // Show the error message somewhere
    alert(&quot;Error: &quot; + error.code + &quot; &quot; + error.message);
  }
});
</code></pre>

<p>这样会尝试匹配给定的email和用户的email或者username字段，然后会发送用户的密码重设邮件。由于我们是这样做的，所以你可以选择用户是否拿email作为他们的用户名，或者说用户把email作为用户的另一个信息保存。</p>
<p>密码重设的流程如下:</p>
<ol>
<li>用户输入email来请求重设他们的密码。</li>
<li>Bmob向用户的email地址发送邮件，包含了一个重设密码的链接。</li>
<li>用户点击这个重设密码的链接，会重定向到一个Bmob页面来允许他们重设密码。</li>
<li>用户输入新的密码，他们的密码现在会更新为输入的新密码。</li>
</ol>
<h3 id="_51">查询<a class="headerlink" href="#_51" title="Permanent link">&para;</a></h3>
<p>为了查询用户，你可以简单的创建一个<code>Bmob.Query</code>针对<code>Bmob.Users</code>：</p>
<pre><code>var query = new Bmob.Query(Bmob.User);
query.equalTo(gender, &quot;female&quot;);  // find all the women
query.find({
  success: function(women) {
    // Do stuff
  }
});
</code></pre>

<h3 id="_52">关联<a class="headerlink" href="#_52" title="Permanent link">&para;</a></h3>
<p>关联一个<code>Bmob.User</code>的对象可以很快就见效，比如说，假设你有一个blog程序，为了保存一个用户的新post还有读取他们所有的post。</p>
<pre><code>var user = Bmob.User.current();

// Make a new post
var Post = Bmob.Object.extend(&quot;Post&quot;);
var post = new Post();
post.set(&quot;title&quot;, &quot;My New Post&quot;);
post.set(&quot;body&quot;, &quot;This is some great content.&quot;);
post.set(&quot;user&quot;, user);
post.save(null, {
  success: function(post) {
    // Find all posts by the current user
    var query = new Bmob.Query(Post);
    query.equalTo(&quot;user&quot;, user);
    query.find({
      success: function(usersPosts) {
        // userPosts contains all of the posts by the current user.
      }
    });
  }
});
</code></pre>

<h2 id="_53">实时数据平台<a class="headerlink" href="#_53" title="Permanent link">&para;</a></h2>
<h3 id="_54">实时功能简介<a class="headerlink" href="#_54" title="Permanent link">&para;</a></h3>
<p>Bmob提供了数据实时功能，当开发者监听某个变化事件，例如监听表更新时，表的内容一旦变化，服务器就会通知SDK，SDK提供了相应回调函数来给开发者使用。当然开发者也可以取消相对应的监听，这样就不会收到数据变化的消息了。</p>
<p><strong>注意！！！运行的html文件应该是在web环境中，不能在本地环境中运行。</strong>
例如，合法的运行环境：http://local.project/appweb/sdk/js/demo/bmobSocketIo.html
无效的本地运行环境：file:///D:/jeff/project/appweb/sdk/js/%E6%95%B0%E6%8D%AE%E5%AE%9E%E6%97%B6%E5%B9%B3%E5%8F%B0/test/bmobSocketIo.html</p>
<h3 id="js">安装实时数据平台的js<a class="headerlink" href="#js" title="Permanent link">&para;</a></h3>
<p>一、把下面这行代码加入你的页面中，其中，"bmobSocketIo.js"为实时数据平台的js文件。</p>
<pre><code>&lt;script type=&quot;text/javascript&quot; src=&quot;bmobSocketIo.js&quot;&gt;&lt;/script&gt;
</code></pre>

<p>二、接着是加入下面这行代码进行初始化。</p>
<pre><code>BmobSocketIo.initialize(&quot;你的Application ID&quot;);
</code></pre>

<h3 id="_55">订阅事件<a class="headerlink" href="#_55" title="Permanent link">&para;</a></h3>
<h4 id="_56">订阅表更新的事件<a class="headerlink" href="#_56" title="Permanent link">&para;</a></h4>
<p>订阅表"GameScore"更新的事件。</p>
<pre><code>BmobSocketIo.updateTable(&quot;GameScore&quot;);
</code></pre>

<h4 id="_57">订阅行更新的事件<a class="headerlink" href="#_57" title="Permanent link">&para;</a></h4>
<p>订阅表"GameScore"中行objectId为"3342e40e4f"更新的事件。</p>
<pre><code>BmobSocketIo.updateRow(&quot;GameScore&quot;,&quot;3342e40e4f&quot;);
</code></pre>

<h4 id="_58">订阅行删除的事件<a class="headerlink" href="#_58" title="Permanent link">&para;</a></h4>
<p>订阅表"GameScore"中行objectId为"3342e40e4f"删除的事件。</p>
<pre><code>BmobSocketIo.deleteRow(&quot;GameScore&quot;,&quot;1256e40e4f&quot;);
</code></pre>

<h3 id="_59">取消订阅事件<a class="headerlink" href="#_59" title="Permanent link">&para;</a></h3>
<h4 id="_60">取消订阅表更新的事件<a class="headerlink" href="#_60" title="Permanent link">&para;</a></h4>
<p>取消订阅表"GameScore"更新的事件。</p>
<pre><code>BmobSocketIo.unsubUpdateTable(&quot;GameScore&quot;);
</code></pre>

<h4 id="_61">取消订阅行更新的事件<a class="headerlink" href="#_61" title="Permanent link">&para;</a></h4>
<p>取消订阅表"GameScore"中objectId为"3342e40e4f"行更新的事件。</p>
<pre><code>BmobSocketIo.unsubUpdateRow(&quot;GameScore&quot;,&quot;3342e40e4f&quot;);
</code></pre>

<h4 id="_62">取消订阅行删除的事件<a class="headerlink" href="#_62" title="Permanent link">&para;</a></h4>
<p>取消订阅表"GameScore"中objectId为"3342e40e4f"行删除的事件。</p>
<pre><code>BmobSocketIo.unsubDeleteRow(&quot;GameScore&quot;,&quot;1256e40e4f&quot;);
</code></pre>

<h3 id="_63">监听触发的事件<a class="headerlink" href="#_63" title="Permanent link">&para;</a></h3>
<h4 id="_64">监听更新表的事件<a class="headerlink" href="#_64" title="Permanent link">&para;</a></h4>
<p>当订阅了表更新的表数据发送变化时，js中会触发函数onUpdateTable。</p>
<p>tablename为更新的表，data为服务端返回的更新数据。</p>
<pre><code>   BmobSocketIo.onUpdateTable = function(tablename,data) {    
      //业务逻辑的代码
   };
</code></pre>

<h4 id="_65">监听行更新的事件<a class="headerlink" href="#_65" title="Permanent link">&para;</a></h4>
<p>tablename为更新的表，objectId为更新行的objectId，data为服务端返回的更新数据。</p>
<pre><code>   BmobSocketIo.onUpdateRow = function(tablename,objectId,data) {    
      //业务逻辑的代码
   };
</code></pre>

<h4 id="_66">监听行删除的事件<a class="headerlink" href="#_66" title="Permanent link">&para;</a></h4>
<p>tablename为更新的表，objectId为更新行的objectId，data为服务端返回的更新数据。</p>
<pre><code>   BmobSocketIo.onDeleteRow = function(tablename,objectId,data) {    
      //业务逻辑的代码
   };
</code></pre>

<h3 id="demo">demo<a class="headerlink" href="#demo" title="Permanent link">&para;</a></h3>
<p>在线上演示实时数据平台的一个聊天应用的demo：<a href="http://chatroom.bmob.cn">chat room demo</a> ，演示了如何使用实时数据服务实现聊天的功能。</p>
<p>用浏览器打开两个窗口，在其中一个窗口输入<code>昵称</code>和<code>内容</code>，按<code>发送</code>按钮，在另外一个窗口能看到发送的内容。</p>
<p><img alt="" src="../image/chatdemo.jpg" /></p>
<h2 id="acl">ACL和角色<a class="headerlink" href="#acl" title="Permanent link">&para;</a></h2>
<p>数据安全是软件系统中最重要的组成部分，为了更好的保护应用数据的安全，Bmob在软件架构层面提供了应用层次、表层次、ACL（Access Control List：访问控制列表）、角色管理（Role）四种不同粒度的权限控制的方式，确保用户数据的安全（详细请查看<a href="http://docs.bmob.cn/other/Other/m_bql/doc/index.html">Bmob数据与安全页面</a>，了解Bmob如何保护数据安全）。</p>
<p>其中，最灵活的方法是通过ACL和角色，它的思路是每一条数据有一个用户和角色的列表，以及这些用户和角色拥有什么样的许可权限。</p>
<p>大多数应用程序需要对不同的数据进行灵活的访问和控制，这就可以使用Bmob提供的ACL模式来实现。例如：</p>
<ul>
<li>对于私有数据，读写权限可以只局限于数据的所有者。</li>
<li>对于一个论坛，会员和版主有写的权限，一般的游客只有读的权限。</li>
<li>对于日志数据只有开发者才能够访问，ACL可以拒绝所有的访问权限。</li>
<li>属于一个被授权的用户或者开发者所创建的数据，可以有公共的读的权限，但是写入权限仅限于管理者角色。</li>
<li>一个用户发送给另外一个用户的消息，可以只给这些用户赋予读写的权限。</li>
</ul>
<h3 id="acl_1">ACL的格式<a class="headerlink" href="#acl_1" title="Permanent link">&para;</a></h3>
<p>在Bmob中，ACL是按JSON对象格式（key-value）来表示的。这个JSON对象的key是objectId（用户表某个用户对应的objectId）或者是*(表示公共的访问权限)，ACL 的值是"读和写的权限"，这个JSON对象的key总是权限名，而这些key的值总是true。</p>
<p>如果您想让一个id为"Kc3M222k"的用户有读和写一条数据的权限，而且这个数据应该可以被全部人读取的话，这个ACL的表达方式如下：</p>
<pre><code>{
  &quot;Kc3M222k&quot;: {
    &quot;read&quot;: true,
    &quot;write&quot;: true
  },
  &quot;*&quot;: {
    &quot;read&quot;: true
  }
}
</code></pre>

<h3 id="_67">角色和相关操作<a class="headerlink" href="#_67" title="Permanent link">&para;</a></h3>
<p>在很多情况下，你需要定义一些用户具有某种相同的数据操作权限，而另外一群用户具有另外一种相同的数据操作权限，这时你就可以使用到Bmob的角色（对应Bmob在Web提供的Role表、SDK中的BmobRole类）功能，设置不同的用户组不同的操作权限。角色表有三个特殊字段：</p>
<p><code>name</code> : 必须字段，表示角色名称,而且只允许被设置一次（命名必须由字母, 空格, 减号或者下划线构成）。</p>
<p><code>users</code> :一个指向一系列用户的关系, 这些用户会继承角色的权限。</p>
<p><code>roles</code> : 一个指向一系列子角色的关系, 这些子关系会继承父角色所有的权限。</p>
<h3 id="_68">创建角色<a class="headerlink" href="#_68" title="Permanent link">&para;</a></h3>
<pre><code>var roleACL = new Bmob.ACL();
roleACL.setPublicReadAccess(true);
var role = new Bmob.Role(&quot;test&quot;, roleACL);
role.save();
</code></pre>

<h3 id="_69">角色对象的安全性<a class="headerlink" href="#_69" title="Permanent link">&para;</a></h3>
<p><code>Bmob.Role</code>使用和其他Bmob对象一样的ACL权限策略, 除开它需要ACL被显式地设置以外。通常来说，只有用户有极大的权限（比如管理员）才应该被允许创建或者更改Role，所以你应该按这种标准来设定Role的ACL。请注意，如果你给了用户一个<code>Bmob.Role</code>一个写权限，这个用户有可能会在这个权限中加入另一个user，或者甚至直接把角色删除掉。</p>
<p>为了创建一个新的<code>Bmob.Role</code>，你应该如下写：</p>
<pre><code>// By specifying no write privileges for the ACL, we can ensure the role cannot be altered.
var roleACL = new Bmob.ACL();
roleACL.setPublicReadAccess(true);
var role = new Bmob.Role(&quot;Administrator&quot;, roleACL);
role.save();
</code></pre>

<p>你可以通过增加"user"和"roles"关系的成员来在<code>Bmob.Role</code>中加入用户或者子角色：</p>
<pre><code>var role = new Bmob.Role(roleName, roleACL);
for (var i = 0; i &lt; usersToAddToRole.length; i++) {
  role.getUsers().add(usersToAddToRole[i]);
}
for (var i = 0; i &lt; rolesToAddToRole.length; i++) {
  role.getRoles().add(rolesToAddToRole[i]);
}
role.save();
</code></pre>

<p><strong>请非常注意一点，注册角色的ACL的时候，它们只能被应该有权限修改它的人修改。</strong></p>
<h3 id="_70">其他对象的安全性<a class="headerlink" href="#_70" title="Permanent link">&para;</a></h3>
<p>现在你应该已经创建了在你的程序中要使用的一系列的角色，你可以用ACL来定义他们的用户可以拥有的权限，每一个<code>Bmob.Object</code>都可以指定一个<code>Bmob.ACL</code>，这样提供了哪些用户或者角色应该有权限来读或者写这个对象。</p>
<p>将一个读或者写的权限授予一个角色是很直观的，你可以使用<code>Bmob.Role</code>：</p>
<pre><code>var moderators = /* Query for some Bmob.Role */;
var wallPost = new Bmob.Object(&quot;WallPost&quot;);
var postACL = new Bmob.ACL();
postACL.setRoleWriteAccess(moderators, true);
wallPost.setACL(postACL);
wallPost.save();
</code></pre>

<p>你可以不需要查找这个Role，直接把名字提供给ACL：</p>
<pre><code>var wallPost = new Bmob.Object(&quot;WallPost&quot;);
var postACL = new Bmob.ACL();
postACL.setRoleWriteAccess(&quot;Moderators&quot;, true);
wallPost.setACL(postACL);
wallPost.save();
</code></pre>

<h3 id="_71">角色继承<a class="headerlink" href="#_71" title="Permanent link">&para;</a></h3>
<p>就像上面所描述的一样，一个角色可能包含其他的角色，表示两个角色之间的父-子关系，这样做的结果就是任何被授予一个角色的权限都会被隐式地授予这个角 色的所有子角色。</p>
<p>这样的关系很经常会在有用户管理内容的程序之中看到，比如论坛，有一个很少量的用户称为管理员，有最高的权限，比如程序设定、创建新的论坛、设定所有人能看到的内容等等。另一类有一部分类似于"版主" 的用户，这些人有责任保持用户创建的内容是合适的，任何一个"版主"有的权限"管理员"都应该有。为了启用这种关系，你应该使"管理员"成为"版主"的一个子角色。</p>
<pre><code>var administrators = /* Your &quot;Administrators&quot; role */;
var moderators = /* Your &quot;Moderators&quot; role */;
moderators.getRoles().add(administrators);
moderators.save();
</code></pre>

<h2 id="_72">地理位置<a class="headerlink" href="#_72" title="Permanent link">&para;</a></h2>
<h3 id="_73">创建地理位置对象<a class="headerlink" href="#_73" title="Permanent link">&para;</a></h3>
<p>地理位置对象的创建需要用到<code>Bmob.GeoPoint</code>类，如创建一个地理位置在纬度40度，经度在-30度的点的示例代码如下：</p>
<pre><code>var point = new Bmob.GeoPoint({latitude: 40.0, longitude: -30.0});
</code></pre>

<h3 id="_74">查询地理位置对象<a class="headerlink" href="#_74" title="Permanent link">&para;</a></h3>
<p>现在你可以有一系列的对象可以做空间坐标查询了，如果能轻松地发现有哪些对象离一个点最近就好了。这样可以通过在<code>Bmob.Query</code>中加入一个<code>near</code>来做查询，为了获得离用户最近的10个地点列表，可以这样：</p>
<pre><code>// location对应Web后台的一个字段名称
var userGeoPoint = userObject.get(&quot;location&quot;);
// 创建查询
var query = new Bmob.Query(PlaceObject);
// location附近的位置
query.near(&quot;location&quot;, userGeoPoint);
// 返回10个地点数据
query.limit(10);
// 查询
query.find({
  success: function(placesObjects) {
  }
});
</code></pre>

<p>在这时<code>placeObjects</code>会返回一个按离<code>userGeoPoint</code>的距离排序的列表，注意如果一个<code>ascending()/descending()</code>给了查询的话，会取代按距离排序这项特性。</p>
<p>为了按距离限制返回的结果，你可以使用<code>withinMiles</code>、<code>withinKilometers</code>和<code>withinRadians</code>。</p>
<p>同样，查询在特定地域的Object是可以的。为了找到用矩形表示的一块地域中的对象，加入<code>withinGeoBox</code>来在<code>Bmob.Query</code>中加入约束。</p>
<pre><code>var southwestOfSF = new Bmob.GeoPoint(37.708813, -122.526398);
var northeastOfSF = new Bmob.GeoPoint(37.822802, -122.373962);

var query = new Bmob.Query(PizzaPlaceObject);
query.withinGeoBox(&quot;location&quot;, southwestOfSF, northeastOfSF);
query.find({
  success: function(pizzaPlacesInSF) {
    ...
  }
});
</code></pre>

<h2 id="_75">错误代码详细说明<a class="headerlink" href="#_75" title="Permanent link">&para;</a></h2>
<p><a href="http://docs.bmob.cn/data/Restful/g_errorcode/doc/index.html" title="错误码列表">错误码列表</a></p>
                </div>
            </div>
        </div>

        
            <script>var base_url = '../../..';</script>
            <script src="../../../js/jquery-1.10.2.min.js"></script>
            <script src="../../../js/bootstrap-3.0.3.min.js"></script>
            <script src="../../../js/highlight.pack.js"></script>
            <script src="../../../js/main.js"></script>
            <script src="../../../js/base.js"></script>

        <div id="go-top"><i class="fa fa-chevron-up"></i></div>
        <a href="https://docs.bmob.cn/data/Android/a_faststart/doc/index.html" id="back" target="_blank">返回 <br> 旧版</a>
    </body>

</html>